home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-21 / clockdv.zip / CLOCK.MAN < prev    next >
Text File  |  1992-08-21  |  13KB  |  446 lines
  1. NAME
  2.  
  3.   Clock - DESQview/X Analog/Digital Clock
  4.  
  5.  
  6. DESCRIPTION
  7.  
  8.   The Clock program displays the time in analog and digital forms.
  9.  
  10.   The time is continuously updated at a frequency which can be specified by
  11.   the user.
  12.  
  13.   Press any key or click on any mouse button to switch between a
  14.   conventional 12-hour analog clock, an "ampm" 12-hour digital clock and
  15.   a "military" 24-hour digital clock.
  16.  
  17.   A stopwatch option is also provided which displays in the 24-hour digital
  18.   format with standard 2-button (Start/Stop and Lap/Reset) functionality.
  19.  
  20.  
  21. SYNOPSIS
  22.  
  23.   clock [options]
  24.  
  25.   options:
  26.  
  27.     [{-dp | -display} <display name>]
  28.  
  29.     [{-ti | -title} <name>]
  30.     [{-g | -geometry} [<width>][x<height>][{+-}<xoffset>[{+-}<yoffset>]]]
  31.     [{-pd | -padding} <pixels>]
  32.  
  33.     [{-in | -iconname} <icon name>]
  34.     [{-ig | -icongeometry} [<width>][x<height>][{+-}<xoffset>[{+-}<yoffset>]]]
  35.     [{-ic | -iconic}]
  36.  
  37.     [{-an | -analog} | {-d | -digital} | -ampm]
  38.     [{-ns | -noswitch}]
  39.  
  40.     [{-sw | -stopwatch}]
  41.  
  42.     [{-up | -update} <seconds>]
  43.     [{-ch | -chime}]
  44.     [{-of | -offset} [{+-}]<hh[:mm[:ss]]>]
  45.  
  46.     [{-fn | -font} <font name>]
  47.     [{-sfn | -sfont} -<foundry>[-<family>[-<weight>[-<slant>]]]]
  48.  
  49.     [{-rv | -reverse}]
  50.     [{-bg | -background} <color>]
  51.     [{-fg | -foreground} <color>]
  52.     [{-hd | -hands}      <color>]
  53.     [{-hl | -highlight}  <color>]
  54.     [{-hr | -hours}      <color>]
  55.  
  56.     [{-ro | -roman}]
  57.     [{-3 | -mult3}]
  58.     [{-nh | -nohours}]
  59.     [{-nt | -noticks}]
  60.  
  61.     [-xrm <resource name/class storage key>:<resource value>]
  62.     [-name <resource name retrieval key parent>]
  63.  
  64.     [-help]
  65.  
  66.  
  67. EXAMPLES
  68.  
  69.   Display three separate clocks with differing titles, hour offsets and window
  70.   positions:
  71.  
  72.     clock -title Hawaii        -offset -3 -g 160x160+0+0
  73.     clock -title "Los Angeles"            -g 160x160+160+0
  74.     clock -title "New York"    -offset +3 -g 160x160+320+0
  75.  
  76.   Start three separate iconified clocks with differing titles, hour offsets
  77.   and colors:
  78.  
  79.     clock -title Hawaii        -offset -3 -iconic -bg green -fg white
  80.     clock -title "Los Angeles"            -iconic -bg yellow
  81.     clock -title "New York"    -offset +3 -iconic -bg LightGray
  82.  
  83.   Start three separate clocks using the -name option to retrieve differing
  84.   resource values from the default \DVX\APP-DEFA\CLOCK.RES resource database
  85.   file:
  86.  
  87.     clock -name hawaii
  88.     clock -name losAngeles
  89.     clock -name newYork
  90.  
  91.   Start a stopwatch clock with a specified title:
  92.  
  93.     clock -sw -title StopWatch
  94.  
  95.  
  96. OPTIONS
  97.  
  98.   -dp or -display <name>
  99.  
  100.     Specifies the default host and display number.
  101.  
  102.   -ti or -title <title>
  103.  
  104.     Specifies the title for the clock's main and icon windows.
  105.  
  106.     The default is "Clock".
  107.  
  108.   -g or -geometry <width>x<height>{+-}<xoffset>{+-}<yoffset>
  109.  
  110.     Specifies the initial window geometry (dimensions and position) in pixels.
  111.  
  112.     The default is "164x164+0+0" for analog and "164x41+0+0" for digital clocks.
  113.  
  114.   -pd or -padding <pixels>
  115.  
  116.     Specifies the width in pixels of the padding between the window border and
  117.     face of an analog clock.
  118.  
  119.     The default is 0.
  120.  
  121.   -in or -iconname <title>
  122.  
  123.     Specifies the title for the clock's icon window.
  124.  
  125.     The default is "Clock".
  126.  
  127.   -ig or -icongeometry
  128.     [<width>][x<height>]
  129.       [{+-}<xoffset>[{+-}<yoffset>]]
  130.  
  131.     Specifies the icon's window geometry (dimensions and position) in pixels.
  132.  
  133.     The default is determined by the window manager.
  134.  
  135.   -ic or -iconic
  136.  
  137.     Indicates that the clock's window should start up iconified.
  138.  
  139.     This is not the default.
  140.  
  141.   -an or -analog
  142.  
  143.     Indicates that the clock should start up as a conventional 12-hour analog
  144.     clock face with hour numbers (1 - 12), tick marks and hands.
  145.  
  146.     This is the default.
  147.  
  148.   -d or -digital
  149.  
  150.     Indicates that the clock should start up as a 24-hour digital clock.
  151.  
  152.     The default is an analog clock.
  153.  
  154.   -ampm
  155.  
  156.     Indicates that the clock should start up as a 12-hour digital clock that
  157.     also displays "a" when A.M. and "p" when P.M.
  158.  
  159.     The default is an analog clock.
  160.  
  161.   -ns or -noswitch
  162.  
  163.     Indicates that the clock does not switch between 12-hour analog, 12-hour
  164.     digital and 24-hour digital modes when a key is pressed or mouse button is
  165.     clicked.
  166.  
  167.     This is not the default.
  168.  
  169.   -sw or -stopwatch
  170.  
  171.     Indicates that the clock should start up as a 24-hour digital stopwatch
  172.     with the standard 2-button (Start/Stop and Lap/Reset) functionality.
  173.     Press Button 1 or the Space key for Start/Stop.  Press Button 3 or the Esc
  174.     key for Lap/Reset.
  175.  
  176.     This is not the default.
  177.  
  178.   -up or -update <seconds>
  179.  
  180.     Specifies the frequency in seconds at which the clock should update its
  181.     display.  If the clock is obscured and then exposed, it will be updated
  182.     immediately.
  183.  
  184.     A value of 60 seconds or less will enable a second hand on an analog clock
  185.     and seconds digits on a digital clock.
  186.  
  187.     The default is 1 second.
  188.  
  189.   -of or -offset [{+-}]<hh:mm:ss>
  190.  
  191.     Specifies the plus or minus time offset (in hours[:minutes[:seconds]]) to
  192.     add to the time reported by the system clock.
  193.  
  194.     The default is 0 (no offset).
  195.  
  196.   -ch or -chime
  197.  
  198.     Indicates that the clock should chime once on the half hour and twice on
  199.     the hour.
  200.  
  201.     This is not the default.
  202.  
  203.   -fn or -font <font name>
  204.  
  205.     Specifies the font (scalable or non-scalable) to be used for displaying
  206.     the hour numbers on an analog clock and the digits on a digital clock.
  207.  
  208.     The default is NULL.
  209.  
  210.   -sfn or -sfont -<foundry>[-<family>[-<weight>[-<slant>]]]
  211.  
  212.     Specifies the scalable font's foundry, family, weight and slant to be used
  213.     for displaying the hour numbers on an analog clock and the digits on a
  214.     digital clock.
  215.  
  216.     The default is "-adobe-times-bold-r".
  217.  
  218.   -rv or -reverse
  219.  
  220.     Indicates that the clock colors should display in reverse-video, with the
  221.     background color defaulting to black and the foreground to white.
  222.  
  223.     This is not the default.
  224.  
  225.   -bg or -background <color>
  226.  
  227.     Specifies the background color of the clock.
  228.  
  229.     If reverse-video is specified, the default is black.  Otherwise, the
  230.     default is white.
  231.  
  232.   -fg or -foreground <color>
  233.  
  234.     Specifies the color of the tick marks on an analog clock and the digits
  235.     on a digital clock.
  236.  
  237.     If reverse-video is specified, the default is white.  Otherwise, the
  238.     default is black.
  239.  
  240.   -hd or -hands <color>
  241.  
  242.     Specifies the color of the insides of the hands on an analog clock.
  243.  
  244.     If reverse-video is specified, the default is white.  Otherwise, the
  245.     default is black.
  246.  
  247.   -hl or -highlight <color>
  248.  
  249.     Specifies the color used to highlight the edges of the hands on an analog
  250.     clock.
  251.  
  252.     If reverse-video is specified, the default is white.  Otherwise, the
  253.     default is black.
  254.  
  255.   -hr or -hours <color>
  256.  
  257.     Specifies the color of the hour numbers on the face of an analog clock.
  258.  
  259.     If reverse-video is specified, the default is white.  Otherwise, the
  260.     default is black.
  261.  
  262.   -ro or -roman
  263.  
  264.     Indicates that Roman numerals (I - XII) should be used as the hour numbers
  265.     of an analog clock instead of the normal Arabic numeral digits (1 - 12).
  266.     Note that the Clock program uses the "IIII" convention instead of "IV"
  267.     for the hour number "4".
  268.  
  269.     This is not the default.
  270.  
  271.   -3 or -mult3
  272.  
  273.     Indicates that only the hour numbers which are multiples of 3 (3, 6, 9, 12
  274.     or III, VI, IX, XII) should be displayed on the face of an analog clock.
  275.  
  276.     This is not the default.
  277.  
  278.   -nh or -nohours
  279.  
  280.     Indicates that no hour numbers should be displayed on the face of an analog
  281.     clock.
  282.  
  283.     This is not the default.
  284.  
  285.   -nt or -noticks
  286.  
  287.     Indicates that no tick marks should be displayed on the face of an analog
  288.     clock.
  289.  
  290.     This is not the default.
  291.  
  292.   -xrm <resource name/class storage key>:<resource value>
  293.  
  294.     Stores a fully-specified resource name/class storage key and value pair
  295.     into the application's resource database file(s) for later retrieval.
  296.  
  297.   -name <resource name retrieval key parent>
  298.  
  299.     Specifies the parent component of the resource name retrieval key used
  300.     to retrieve values from the application's resource database file(s).
  301.  
  302.     The default is "clock".
  303.  
  304.   -help or any unsupported option
  305.  
  306.     Indicates that a brief summary of the allowed options should be printed on
  307.     the standard error output device.
  308.  
  309.  
  310. RESOURCE OPTIONS
  311.  
  312.   Option            Name                Class              Default Value
  313.   ------            ----                -----              -------------
  314.  
  315.   -title            title               Title              Clock
  316.   -geometry         geometry            Geometry           164x164
  317.   -padding          padding             Margin             0
  318.  
  319.   -iconname         iconName            Title              Clock
  320.   -icongeometry     iconGeometry        Geometry           NULL
  321.  
  322.   -iconic           iconStartup         Boolean            False
  323.  
  324.   -analog           analog              Boolean            True
  325.   -digital
  326.   -ampm             ampm                Boolean            False
  327.   -noswitch         switchModes         Boolean            True
  328.  
  329.   -stopwatch        stopWatch           Boolean            False
  330.  
  331.   -update           update              Interval           1
  332.   -chime            chime               Boolean            False
  333.   -offset           timeOffset          Time               0
  334.  
  335.   -font             font                Font               NULL
  336.   -sfont            scalableFont        ScalableFont       -adobe-times-bold-r
  337.  
  338.   -reverse          reverseVideo        ReverseVideo       False
  339.   -foreground       foreground          Foreground         black
  340.   -background       background          Background         white
  341.   -hands            hand                Foreground         black
  342.   -highlight        highlight           Foreground         black
  343.   -hours            hour                Foreground         black
  344.  
  345.   -roman            romanNumerals       Boolean            False
  346.   -mult3            multiplesOf3        Boolean            False
  347.   -nohours          showHours           Boolean            True
  348.   -noticks          showTicks           Boolean            True
  349.  
  350.  
  351. DOS ENVIRONMENT VARIABLES
  352.  
  353.   DISPLAY=<display name>
  354.  
  355.   Specifies the default host and display number.
  356.  
  357.   HOME=<home directory>
  358.  
  359.   Specifies the "home" directory used to form the path of a resource file that
  360.   overrides the global resources.
  361.  
  362.   XENVIRONMENT=<resource file>
  363.  
  364.   Specifies the name of a resource file that overrides the global resources.
  365.  
  366.  
  367. RESOURCE SPECIFICATIONS
  368.  
  369.   \DVX\APP-DEFA\CLOCK.RES resource file
  370.  
  371.   RESOURCE_MANAGER server property
  372.  
  373.     %HOME%\XDEFAULT.RES resource file
  374.  
  375.   %XENVIRONMENT% resource file
  376.  
  377.     %HOME%\<host>\XDEFAULT.RES resource file
  378.  
  379.   command-line options
  380.  
  381.  
  382. RESOURCE NAME AND CLASS KEY PARENTS
  383.  
  384.   Name Key Parent:   clock
  385.   Class Key Parent:  Clock
  386.  
  387.  
  388. SAMPLE RESOURCE FILE (\DVX\APP-DEFA\CLOCK.RES)
  389.  
  390.   # class-level resources set to application's default values.
  391.  
  392.   Clock*Title:              Clock
  393.  
  394.   Clock*Foreground:         black
  395.   Clock*Background:         white
  396.  
  397.   Clock.geometry:           164x164
  398.   Clock.padding:            0
  399.  
  400.   Clock.iconStartup:        False
  401.  
  402.   Clock.analog:             True
  403.   Clock.ampm:               False
  404.   Clock.switchModes:        True
  405.  
  406.   Clock.stopWatch:          False
  407.  
  408.   Clock.update:             1
  409.   Clock.chime:              False
  410.   Clock.timeOffset:         0
  411.  
  412.   Clock.romanNumerals:      False
  413.   Clock.multiplesOf3:       False
  414.   Clock.showHours:          True
  415.   Clock.showTicks:          True
  416.  
  417.   # "Hawaii" clock resources invoked by "clock -name hawaii"
  418.  
  419.   hawaii*Title:             Hawaii
  420.   hawaii.timeOffset:        -3
  421.   hawaii.geometry:          160x160
  422.   hawaii*Background:        green
  423.   hawaii*Foreground:        white
  424.  
  425.   # "Los Angeles" clock resources invoked by "clock -name losAngeles"
  426.  
  427.   losAngeles*Title:         Los Angeles
  428.   losAngeles.timeOffset:    0
  429.   losAngeles.geometry:      160x160+160+0
  430.   losAngeles*Background:    yellow
  431.  
  432.   # "New York" clock resources invoked by "clock -name newYork"
  433.  
  434.   newYork*Title:            New York
  435.   newYork.timeOffset:       +3
  436.   newYork.geometry:         160x160+320+0
  437.   newYork*Background:       LightGray
  438.  
  439.  
  440. COPYRIGHT
  441.  
  442.   Copyright (c) 1987-89 Digital Equipment Corporation and
  443.     the Massachusetts Institute of Technology.
  444.   Copyright (c) 1992 Quarterdeck Office Systems, Inc.
  445.  
  446.